Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

Constants

Gestalt Selectors

You can use the QAEngineGestalt function to get information about a drawing engine. You pass QAEngineGestalt a selector that determines the kind of information about the engine you want to receive and a pointer to a buffer into which the information is to be copied. The selectors are defined by constants. Note that your application must allocate space for the buffer (pointed to by the response parameter) into which the information is copied.

typedef enum TQAGestaltSelector {
   kQAGestalt_OptionalFeatures= 0,
   kQAGestalt_FastFeatures    = 1,
   kQAGestalt_VendorID        = 2,
   kQAGestalt_EngineID        = 3,
   kQAGestalt_Revision        = 4,
   kQAGestalt_ASCIINameLength = 5,
   kQAGestalt_ASCIIName       = 6,
   kQAGestalt_AvailableTexMem = 7
} TQAGestaltSelector;

Constant descriptions

kQAGestalt_OptionalFeatures

QAEngineGestalt returns a value whose bits encode the optional features supported by the drawing engine. The response parameter must point to a buffer of type unsigned long. See "Gestalt Optional Features Response Masks" (page 1-59) for a description of the meaning of the bits in the returned value.

kQAGestalt_FastFeatures

QAEngineGestalt returns a value whose bits encode the features supported by the drawing engine that are accelerated. The response parameter must point to a buffer of type unsigned long. See "Gestalt Fast Features Response Masks" (page 1-61) for a description of the meaning of the bits in the returned value.

kQAGestalt_VendorID

QAEngineGestalt returns the vendor ID of the drawing engine. The response parameter must point to a buffer of type long. See "Vendor and Engine IDs" (page 1-62) for a list of the currently defined vendor IDs.

kQAGestalt_EngineID

QAEngineGestalt returns the engine ID of the drawing engine. The response parameter must point to a buffer of type long. See "Vendor and Engine IDs" (page 1-62) for a list of the currently defined engine IDs.

kQAGestalt_Revision

QAEngineGestalt returns the revision number of the drawing engine. (Larger numbers indicate more recent revisions.) The response parameter must point to a buffer of type long.

kQAGestalt_ASCIINameLength

QAEngineGestalt returns the number of characters in the ASCII name of the drawing engine. The response parameter must point to a buffer of type long.

kQAGestalt_ASCIIName

QAEngineGestalt returns the ASCII name of the drawing engine. The response parameter must point to a C string whose length you have determined by passing the kQAGestalt_ASCIINameLength selector to QAEngineGestalt.

kQAGestalt_AvailableTexMem

QAEngineGestalt returns the size, in bytes, of the memory available for storing texture maps. Note that the amount of memory required to hold a particular texture map depends on the texture flags of that texture map--in particular, on the texture compression and mipmapping flags. (See "Texture Flags Masks" (page 1-64) for details.) As a result, the size returned by QAEngineGestalt is only a rough indication of the number of texture maps that can be created. The response parameter must point to a buffer of type Size.